home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / lisp / clue.lha / clue / README < prev    next >
Text File  |  1989-07-12  |  3KB  |  86 lines
  1.  
  2.  
  3.                   Common Lisp User Interface Environment (CLUE)
  4.                                                                           
  5.             Copyright (C) 1988, 1989, Texas Instruments Incorporated
  6.  
  7.  
  8. Related Systems
  9.  
  10.     CLUE relies upon two other systems --- CLX and CLOS.
  11.  
  12.     CLX, the Common Lisp X Interface, may be found in the X11 distribution  from
  13.     MIT (see lib/CLX/*).  CLUE requires R3 CLX or later.
  14.  
  15.     CLOS, the Common Lisp Object System,  is a draft standard extension  to ANSI
  16.     Common Lisp  for  object-oriented  programming.   Xerox PCL (Portable Common
  17.     Loops) is an implementation of CLOS  which is available publicly at  no cost
  18.     by sending  a  request  to  CommonLoops.pa@xerox.com.   Sources for a simple
  19.     implementation of a CLOS subset called Clos-Kludge are included in the  CLUE
  20.     directory (see clue/clos-kludge/*).   Clos-Kludge is  sufficient for  simple
  21.     CLUE programming, but it is neither supported nor recommended.
  22.  
  23.  
  24. Installation
  25.  
  26.     Use the functions compile-clue and load-clue in the file clue/defsystem.l.
  27.  
  28.     Note: Because Clos-Kludge  uses DEFSTRUCT  and CLX  windows are  built using
  29.     DEFSTRUCT, no CLX changes are  required when using Clos-Kludge.   When using
  30.     other (better) CLOS implementations,  CLX must be  modified to use  DEFCLASS
  31.     instead of  DEFSTRUCT.   To  do  this,  compile  and  load clue/clos-patch.l
  32.     immediately   after   the   CLX/depdefs.l    file.    See   the    functions
  33.     compile-clos-clx and load-clos-clx functions in clue/defsystem.l.
  34.  
  35.  
  36. Examples
  37.  
  38.     Two sets of examples are provided to  demonstrate the use of CLUE.  See  the
  39.     directory clue/examples/*.
  40.  
  41.     clue/examples/menu.l implements  a  simple  pop-up  menu and several related
  42.     functions.  See clue/doc/examples.text for  a detailed description  of these
  43.     examples.
  44.  
  45.     The directory  clue/examples/old/*  contains  examples  from a previous CLUE
  46.     release.  These examples are somewhat obsolete and are not supported.   They
  47.     do not use recent CLUE  features and are poorly  documented, and not all  of
  48.     them are  carefully  designed  and  tested.   Sources in clue/examples/old/*
  49.     implement a set of contact classes.  See the functions compile-clue-examples
  50.     and  load-clue-examples   in   clue/examples/old/defsystem.l.    Sources  in
  51.     clue/examples/old/demo/* implement  a  set  of  demo  functions,  using  the
  52.     example  contact   classes.    See   the   functions  compile-clue-demo  and
  53.     load-clue-demo in clue/examples/old/demo/defsystem.l.
  54.  
  55.  
  56. Documentation
  57.  
  58.     The directory clue/doc/* contains several documents describing CLUE.
  59.  
  60.     CLUE.PS, CLUE.TEX
  61.  
  62.         The CLUE  specification  which  defines  all  CLUE  features.  LaTeX and
  63.         PostScript versions are included.
  64.  
  65.     EXAMPLES.TEXT
  66.  
  67.         Describes  the  example  in  clue/examples/menu.l.   First-time  readers
  68.         should have first read The Quick and Dirty Guide To CLUE and should have
  69.         some familiarity with the CLUE specification.
  70.  
  71.     RELEASE.TEXT
  72.  
  73.         Release notes for the current version of CLUE.  This contains  important
  74.         information which must be read before using CLUE.
  75.  
  76.     TURBO-CLUE.PS, TURBO-CLUE.TEX
  77.  
  78.         The Quick and Dirty Guide To CLUE.  This tutorial introduces the  novice
  79.         CLUE  programmer  to  the  CLUE  way  of  life  with  examples,  advice,
  80.         installation notes, and  exercises.  LaTeX  and PostScript  versions are
  81.         included.
  82.  
  83.  
  84.  
  85.  
  86.